home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / STSkipTo.z / STSkipTo
Text File  |  1998-10-30  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. SSSSTTTTSSSSkkkkiiiippppTTTToooo((((3333))))                      IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                       SSSSTTTTSSSSkkkkiiiippppTTTToooo((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      STSkipTo - skip forward in a STIFF stream
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssttttddddiiiioooo....hhhh>>>>
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssttttiiiiffffffff....hhhh>>>>
  14.  
  15.      iiiinnnntttt SSSSTTTTSSSSkkkkiiiippppTTTToooo((((SSSSTTTTSSSSttttrrrreeeeaaaammmm ****sssstttt,,,, uuuunnnnssssiiiiggggnnnneeeedddd lllloooonnnngggg ooooffffffffsssseeeetttt))));;;;
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _S_T_S_k_i_p_T_o skips forward in a STIFF stream. This function can be used to
  19.      skip over unneeded data. The stream descriptor _s_t must be a valid open
  20.      STIFF stream pointer. _o_f_f_s_e_t specifies the location in the STIFF stream
  21.      to skip to. The location is specified in bytes from the start of the
  22.      stream and must not be less than the current stream offset.
  23.  
  24.      If the file descriptor associated with _s_t is seekable, then _S_T_S_k_i_p_T_o can
  25.      also be used to skip backward.
  26.  
  27. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  28.      _S_T_S_k_i_p_T_o returns 0 if execution was successful. -1 is returned and
  29.      _S_T_e_r_r_n_o is set if an execution error has occurred.
  30.  
  31. EEEEXXXXEEEECCCCUUUUTTTTIIIIOOOONNNN EEEERRRRRRRROOOORRRR CCCCOOOODDDDEEEESSSS
  32.      _S_T_S_k_i_p_T_o will fail under the following circumstances.
  33.  
  34.      STENEEDSEEK              Operation requires seeking on a stream.
  35.  
  36.      STESYSCALL               System call failed.
  37.  
  38. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  39.      libstiff(3).
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.